home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
edit
/
me_cd.zip
/
ME.DOC
< prev
next >
Wrap
Text File
|
1988-10-24
|
35KB
|
742 lines
========================================================================
== ME Documentation Craig Durland 8/88 ==
========================================================================
ME is a small, portable, extendable Emacs like editor. This document
describes how individual commands work - it is light on general usage.
If you need to learn Emacs, look at the GNU, Goslings or Unipress Emacs
manuals.
DOC FILE What it covers
-------- ------------------------------------------
CMDS.DOC Keys and what they are bound to.
ME.DOC (this file) ME built in commands.
MEMUTT.DOC The ME extensions to Mutt and ME system variables.
MUTT.DOC The Mutt programming language and Mutt compiler.
ERRATA.DOC Errata, machine specifics and philosophy.
REGEXP.DOC Regular expressions.
========================================================================
== What ME does NOT have that Emacs does ==
========================================================================
* Undo
* File name completion
* Command history (mini buffer editing)
* Multiple key macros, named macros, macros bound to keys
* Recursive editing
* Local syntax tables
a few others
========================================================================
== Soft keys and Function keys ==
========================================================================
When describing characters or keys, the character itself is used if it
is printable. Unprintable characters are made printable using 3 or more
printable characters. For example, the letter "A" is printable but
control-A is not and so the code "C-A" is used to describe it. The
table below shows the various codes needed to map the unprintable keys.
Prefix Meaning
C- Control key.
F- Function or soft key such as f1, Home, etc.
M- Meta key. See META in the GLOSSARY.
S- Shift. This only applies to function keys.
This is a list of "extended" keys - those not covered by ASCII. ME
maps these keys to 3 or more ASCII codes. Ignore the ME key column
unless you are binding keys. The keyboard column is the key on the
keyboard you press to generate the ME key which (unless rebound) fires
off the function listed in the Bound to column.
keyboard ME key Bound to
F1 F-1
F2 F-2
F3 F-3
F4 F-4
F5 F-5
F6 F-6
F7 F-7
F8 F-8
F9 F-9
F10 F-0
home F-A (beginning-of-buffer)
end F-B (end-of-buffer)
up arrow F-C (previous-line)
down arrow F-D (next-line)
right arrow F-E (next-character)
left arrow F-F (previous-character)
insert F-G
delete F-H (delete-character)
page up F-I (previous-page)
page down F-J (next-page)
clear line F-K (kill-line)
delete line F-L
insert line F-M
select F-N (set-mark)
roll up F-O (scroll-down)
roll down F-P (scroll-up)
DEL ^? (delete-character)
ESC ^[
shift tab M-I
ALT 0..9A..Z! mapped to META 0..9A..Z!
Use the ALT key like the control key (ie hold it down while you press the
next key).
========================================================================
========================================================================
Anytime you are being queried on the message line the softkeys return
their internal value. So if you want to bind F1, you can press F1
when bind-to-key asks for a key.
Case of letters:
Meta keys and Control X commands: next letter is ALWAYS uppercase.
Softkeys are case sensitive.
========================================================================
== GLOSSARY ==
========================================================================
^[ See META
args
Parameters or arguments that will be requested by the command. If
[] surround the arg, then it will only be requested in certain cases.
binding See bound.
bound
A key is attached or bound to a command or program.
If the key is pressed, whatever it is bound to is invoked.
Keys can be bound locally or globally. If a key has a local binding,
pressing the key in the buffer it was bound in causes action. A
global binding covers all buffers. Note that local bindings take
precedence over global ones.
buffer
A buffer is the internal workspace. If a buffer is visible, it is
shown through one or more windows. It is usually attached to a file
(ie contains the contents of the file). If the buffer was created
by reading in a file, the buffer name is created by removing the
path from the file name (and leaving only the name and extension).
command or cmd
A ME built in command such as (search-forward).
These can be bound to a key to make executing them easier.
Documented under COMMANDS (in ME.DOC). These are different from
functions in that they can be bound to keys or executed by
(ME-command).
Command completion
ME will attempt to complete a command if the space bar is pressed and
completion is on. The only time you can use command completion is
when you are being queried in the minibuffer. For example, when ME
is requesting a buffer name for (use-existing-buffer) and foobar is
a buffer, typing "foo" and hitting space will fill in the rest of
the name. ME also trys to fix typos. If you had typed "fooie" and
hit the space bar, you still get "foobar". Sometimes, you will hit
space and only part of the command name will appear. This is ME's
way of telling you there is some ambiguity as to the full name.
Type some more of the name and hit space again or press ? to get a
list of possible names.
See also: complete in MEMUTT.DOC.
dot
The place between two characters. It is immediately to the left of
the cursor. Also known as point. One per window or buffer.
ESCAPE See META
The escape key (usally marked ESC on keyboards) acts like the META key
for those keyboards that don't have a META key.
file
For MS-DOS, you can use forward slashes "/" as part of the path name.
function or fcn
The commands that comprise the Mutt programming language. Documented
in MUTT.DOC and MEMUTT.DOC. These differ from commands in that they
cannot be bound to keys and cannot be executed by (ME-command).
help
Help is pretty much limited to reading manuals or asking gurus.
Limited forms of online help are command completion (see above),
typing a ? when being asked a question (see "If you are being
asked a question" below) and (describe-bindings).
keys
Keys are used to enter text and invoke commands. The keys used to
invoke can be one or two keys where each key can have one or more
modifiers.
modifier meaning notes
M- META See META and ESCAPE. Cannot be prefixed.
C- CONTROL
S- SHIFT Only used with nonASCII keys
F- FUNCTION NonASCII keys
See also: prefix-key in MEMUTT.DOC
Kill buffer
An invisible buffer that holds things created by deletion commands
such as (kill-region) and (copy-region). Used to cut and paste, or
just cut, text.
If you want to move a block of text about: 1. set the mark at one end
and then move the dot to the other end. 2. kill the region. 3. move
the dot to the start of where you want the text to begin and 4. yank
the kill buffer. Bingo.
Copy and kill append to the kill buffer if last command was also a
kill or copy, otherwise the kill buffer is cleared before the new text
is entered.
The killbuffer is also used by (filter-region).
macro
A sequence of keystrokes that can be replayed on command. Used when
you don't want to spend the time writing a program. Created by
going through the motions (which are actually done so you can verify
that what you want to happen is actually happening) (see
(start-macro) and (end-macro)). When replayed by (execute-macro),
the exact sequence you typed in is reentered.
mark
A user s